home *** CD-ROM | disk | FTP | other *** search
/ SGI Hot Mix 17 / Hot Mix 17.iso / HM17_SGI / html / vendors / softwarecom / demos / po31-readme-unix.txt < prev    next >
Text File  |  1997-07-09  |  23KB  |  551 lines
  1.  
  2.  
  3. This Read Me file includes:
  4.  
  5.     -  Upgrade instructions for existing users of Post.Office 
  6.        -  Solaris 
  7.        -  HPUX10
  8.        -  All other UNIX platforms 
  9.     -  Installation instructions for new users of Post.Office
  10.        -  Solaris
  11.        -  HPUX10
  12.        -  All other UNIX platforms
  13.  
  14.  
  15. ==========================================================================
  16.  
  17.            UPGRADE INSTRUCTIONS - POST.OFFICE v. 3.1 - UNIX
  18.  
  19. ALL users upgrading to Post.Office 3.1 from version 2.0 need to purchase a
  20. 3.x license, as entry of the 3.x license number is a required step in the 
  21. upgrade operation.  If you are upgrading from version 3.0, no new license
  22. number is required.  If you are upgrading from version 2.0 and do not have
  23. a valid 3.x license number, please contact Sales@Software.com.  
  24.  
  25. Note: The same software is used for installing Post.Office version 3.1,
  26. upgrading from an earlier version (2.0 or 3.0), or entering a new license
  27. number to accommodate additional accounts/mailboxes and mailing lists.  
  28. The program checks to see if Post.Office already exists, then self-adjusts 
  29. to perform the necessary installation or upgrade procedure.  However, 
  30. the upgrade instructions that follow apply to current users of the 
  31. Post.Office software.  If you are installing Post.Office for the first 
  32. time, refer to the Installation Instructions section of this document 
  33. or the detailed instructions in the Post.Office Installation Guide.
  34.  
  35.  
  36. REVIEW THE FOLLOWING *BEFORE* UPGRADING YOUR SYSTEM:
  37. ----------------------------------------------------
  38.  
  39. THE POST.OFFICE UPGRADE OPERATION IS PERFORMING TASKS OF CONSIDERABLE  
  40. COMPLEXITY INCLUDING DATABASE REGENERATION.  TO ENSURE SUCCESS YOU MUST
  41. BACKUP YOUR SYSTEM PRIOR TO UPGRADING AND ALLOW ADEQUATE TIME TO COMPLETE 
  42. THE POST.OFFICE UPGRADE OPERATION.  IT IS ESSENTIAL THAT THE PROCESS 
  43. RUN TO COMPLETION WITHOUT INTERRUPTION.  
  44.  
  45. The time required to execute the upgrade process will vary based on the 
  46. amount of memory, processing speed, and the number of installed accounts.  
  47. Upgrade times of one minute per thousand accounts are typical. 
  48.  
  49. CAUTION:  If you have more than 30,000 mail accounts established on 
  50. your server or if you are making use of linked mailbox directories,
  51. please contact Support@Software.com for assistance before attempting 
  52. to upgrade to Post.Office version 3.1.
  53.  
  54. BACK UP YOUR EXISTING SYSTEM
  55.  
  56. In the interest of safety and good software practices, existing  
  57. users of Post.Office should back up their system before upgrading to 
  58. version 3.1.  Upgrading is a nondestructive process which retains  
  59. all mail, and account and configuration information.  However,  
  60. if the upgrade operation is interrupted your mail system can be   
  61. corrupted. Instructions on restoring your mail system are provided 
  62. in the Backup and Restore section of the FAQ (available at
  63. http://www.software.com/tech/faq/FAQ_Contents.html), but those 
  64. instructions presume existence of the required backup files.
  65.  
  66. To assist you in completing this essential operation, backup instructions 
  67. are included as part of the upgrade instructions that follow.
  68.  
  69. UPDATE ANY CUSTOMIZED FORMS
  70.  
  71. Because Post.Office forms were significantly modified in version 3.x,
  72. users working with customized versions of the Post.Office 2.0 forms need 
  73. to perform the following steps when upgrading their system to version 3.1:
  74.  
  75. 1. Obtain copies of the standard forms for Post.Office version 3.1 by 
  76.    sending a request to Support@Software.com
  77.  
  78. 2. Revise the standard forms as desired.
  79.  
  80. 3. Follow the detailed instructions presented below to backup your system 
  81.    and upgrade the Post.Office software.
  82.  
  83. 4. Once the upgrade process is complete, re-submit your revised versions 
  84.    of the standard 3.1 forms for use with the upgraded system.
  85.  
  86. REMEMBER TO RESTART PROGRAM DELIVERY
  87.  
  88. Please note that Program Delivery is turned off by the upgrade process.
  89. A reminder to re-enable Program Delivery is included in the instructions 
  90. for those users to whom this feature applies. 
  91.  
  92. ADDITIONAL INSTRUCTIONS FOR USERS WHOSE POP AND UNIX MAILBOXES RESIDE IN 
  93. THE SAME DIRECTORY
  94.  
  95. If your UNIX mailboxes and POP mailboxes currently reside in the same 
  96. directory, you will need to perform one additional step at the end of 
  97. the upgrade process.  For details, please refer to the upgrade instructions 
  98. for your particular platform.
  99.  
  100.  
  101. ---------------------------------------------------------------------------
  102.                      Solaris Upgrade Instructions
  103.  
  104. To permit recovery if the upgrade process is accidentally interrupted, 
  105. backup instructions are included among the initial steps in the upgrade 
  106. process.  DO NOT omit this important operation.
  107.  
  108. The following upgrade instructions assume that you have installed Post.Office 
  109. in the default locations which are /opt/post.office (program executables) 
  110. and /var/spool/post.office (the spooling directories).  If you selected other 
  111. locations you will need to adjust the instructions accordingly.  To determine 
  112. the current locations of your Post.Office, Program, and Mailbox directories 
  113. list the contents of the /etc/post.office.conf file.
  114.  
  115. 1. Log on as root.
  116.  
  117. 2. Back up the contents of the following items:
  118.  
  119.    a) /opt/post.office (the Post.Office executables)
  120.  
  121.    b) /var/spool/post.office (the configuration information)
  122.  
  123.    c) /var/spool/mailbox (the mailbox information)
  124.  
  125.    d) /etc/post.office.conf (your configuration file)
  126.  
  127.    Note:  If you aren't already doing so, you should be backing up these 
  128.    directories regularly. 
  129.  
  130. 3. Shutdown Post.Office by typing: 
  131.  
  132.    /opt/post.office/post.office  shutdown
  133.  
  134. 4a. If your software was delivered on CD:  mount the CD on your computer 
  135.     and change directory to the location containing the Post.Office archive
  136.     for your particular operating system/platform.
  137.  
  138. 4b. If you downloaded the software from our ftp or web site:  uncompress 
  139.     the file you downloaded into a temporary directory and expand the resulting 
  140.     archive file to create the Post.Office package (SCOM-MTA) by typing:
  141.  
  142.     cd /var/tmp
  143.     uncompress PO31-solaris2.tar.Z
  144.     tar xvpf PO31-solaris2.tar
  145.  
  146. 5. Remove the old package (the Solaris packaging facility will not let you 
  147.    overwrite an old package with a newer version) by typing:  
  148.  
  149.    pkgrm SCOM-MTA
  150.  
  151.    Note:  This will not remove your current configuration files or change your 
  152.    existing accounts in any way. 
  153.  
  154. 6. Install the new package by typing:  
  155.  
  156.    pkgadd -d . SCOM-MTA
  157.  
  158.    This will "remember" where you had installed everything, and give you the 
  159.    option of skipping the typical  installation Q&A.
  160.  
  161.    CAUTION: The upgrade program will ask if you wish to change 
  162.    configuration information.  You should answer "no".  Only under 
  163.    exceptional circumstances while assisted by support personnel  
  164.    should you modify configuration information while upgrading.
  165.  
  166. 7. If you are currently using Program Delivery you will need to re-enable 
  167.    that feature by typing:
  168.  
  169.    chmod u+s /opt/post.office/local/Program-Deliver
  170.    rm /opt/post.office/trusted/NO-PROGRAM-DELIVERIES
  171.  
  172.   CAUTION:  There are security issues associated with the use of Program 
  173.   Delivery.  Please read Appendix E of the Post.Office manual to ensure 
  174.   you understand those issues before enabling this feature.
  175.  
  176. 8. Run the Post.Office configuration program:  /opt/post.office/Setup
  177.  
  178.    This process configures the new software, allowing retention of 
  179.    all pre-existing configuration parameters. All account information 
  180.    is maintained through this process.
  181.  
  182.    When the Setup program is finished, it will restart Post.Office 
  183.    for you.
  184.  
  185. 9. If your UNIX mailboxes and POP mailboxes are stored in the same 
  186.    directory, you must cd to that directory and run the following file:
  187.  
  188.    <ProgramDirectory>/utils/FixMaildropFile *
  189.  
  190. ---------------------------------------------------------------------------
  191.                         HPUX10 Upgrade Instructions
  192.  
  193. To permit recovery if the upgrade process is accidentally interrupted, 
  194. backup instructions are included among the initial steps in the upgrade 
  195. process.  DO NOT omit this important operation.
  196.  
  197. The following upgrade instructions assume that you have installed Post.Office 
  198. in the default locations which are /usr/local/post.office (program executables) 
  199. and /usr/spool/post.office (the spooling directories).  If you selected other 
  200. locations you will need to adjust the instructions accordingly.  To determine 
  201. the current locations of your Post.Office, Program, and Mailbox directories 
  202. list the contents of the /etc/post.office.conf file.
  203.  
  204. 1. Log on as root.
  205.  
  206. 2. Back up the contents of the following items:
  207.  
  208.    a) /usr/local/post.office (the Post.Office executables)
  209.  
  210.    b) /usr/spool/post.office (the configuration information)
  211.  
  212.    c) /usr/spool/mailbox (the mailbox information)
  213.  
  214.    d) /etc/post.office.conf (your configuration file)
  215.  
  216.    Note:  If you aren't already doing so, you should be backing up these 
  217.    directories regularly. 
  218.  
  219. 3. Shutdown Post.Office by typing:  
  220.  
  221.    /usr/local/post.office/post.office  shutdown
  222.  
  223. 4a. If your software was delivered on CD:  mount the CD on your computer, 
  224.     change directory to the location containing the archive file for the 
  225.     appropriate UNIX platform, copy that archive into a temporary directory, 
  226.     and expand it by typing:
  227.  
  228.     cp XXX.tar* /usr/tmp
  229.     cd /usr/tmp
  230.     tar xvpf XXX.tar*
  231.  
  232.     (where XXX represents your platform type)
  233.  
  234. 4b. If you downloaded the software from our ftp or web site:  uncompress the 
  235.     file you downloaded into the temporary directory and expand the resulting 
  236.     archive file by typing:
  237.  
  238.     cd /usr/tmp
  239.     uncompress PO31-XXX.tar.Z
  240.     tar xvpf PO31-XXX.tar
  241.  
  242.     (where XXX represents your platform type)
  243.  
  244. 5. Change to the newly created directory and install Post.Office version 3.1.
  245.  
  246.    cd Post.Office
  247.    ./installpo
  248.  
  249.    The install script will "remember" where you had installed everything, 
  250.    and give you the option of skipping the Q&A. This procedure will not 
  251.    remove your current configuration files or change your existing 
  252.    accounts in any way.  When the installation program is finished, it 
  253.    will re-start Post.Office for you.
  254.  
  255.    CAUTION: The upgrade program will ask if you wish to change 
  256.    configuration information.  You should answer "no".  Only under 
  257.    exceptional circumstances while assisted by support personnel  
  258.    should you modify configuration information while upgrading.
  259.  
  260. 6. If you are currently using Program Delivery you will need to re-enable 
  261.    that feature by typing:
  262.  
  263.    chmod u+s /usr/local/post.office/local/Program-Deliver
  264.    rm /usr/local/post.office/trusted/NO-PROGRAM-DELIVERIES
  265.  
  266.    Caution:  There are security issues associated with the use of Program 
  267.    Delivery.  Please read Appendix E of the Post.Office manual to ensure 
  268.    you understand those issues before enabling this feature.
  269.  
  270.  
  271. 7. If your UNIX mailboxes and POP mailboxes are stored in the same 
  272.    directory, you must cd to that directory and run the following file:
  273.  
  274.    <ProgramDirectory>/utils/FixMaildropFile *
  275.  
  276. ---------------------------------------------------------------------------
  277.               Upgrade Instructions for all Other UNIX Platforms
  278.  
  279. To permit recovery if the upgrade process is accidentally interrupted, 
  280. backup instructions are included among the initial steps in the upgrade 
  281. process.  DO NOT omit this important operation.
  282.  
  283. The following upgrade instructions assume that you have installed Post.Office   
  284. in the default locations which are /usr/local/post.office (program executables) 
  285. and /var/spool/post.office (the spooling directories).  If you selected other 
  286. locations you will need to adjust the instructions accordingly.  To determine 
  287. the current locations of your Post.Office, Program, and Mailbox directories 
  288. list the contents of the /etc/post.office.conf file.
  289.  
  290. 1. Log on as root.
  291.  
  292. 2. Back up the contents of the following items:
  293.  
  294.    a) /usr/local/post.office (the Post.Office executables)
  295.  
  296.    b) /var/spool/post.office (the configuration information)
  297.  
  298.    c) /var/spool/mailbox (the mailbox information)
  299.  
  300.    d) /etc/post.office.conf (your configuration file)
  301.  
  302.    Note:  If you aren't already doing so, you should be backing up these 
  303.    directories regularly. 
  304.  
  305. 3. Shutdown Post.Office by typing:  
  306.  
  307.    /usr/local/post.office/post.office  shutdown.
  308.  
  309. 4a. If your software was delivered on CD:   mount the CD on your computer 
  310.     and change directory to the location containing files for your particular 
  311.     operating system/platform.
  312.  
  313.        Digital UNIX Note:  The default options used to mount a CD may not 
  314.        be appropriate.  Be sure to specify "cdfs" as the file system type 
  315.        and include the Rock Ridge Interchange Protocol option "rrip".
  316.  
  317.           For example, if your CD ROM device is assigned a SCSI-ID of 6 
  318.           and you want to access the CD ROM from the directory /CDROM, 
  319.           you would use the following command:  
  320.  
  321.           mount -r -t cdfs -o ro,rrip /dev/rz6c /CDROM
  322.  
  323.        SunOS Note:  The default options used to mount a CD may not 
  324.        be appropriate.  Be sure to specify "hsfs" as the file system type.
  325.  
  326. 4b. If you downloaded the software from our ftp or web site:   uncompress the 
  327.     file you downloaded into a temporary directory, expand the resulting 
  328.     archive file, and then change to the newly created directory by typing:
  329.  
  330.     cd /var/tmp
  331.     uncompress PO31-<platform>.tar.Z
  332.     tar xvpf PO31-<platform>.tar
  333.     cd Post.Office
  334.  
  335. 5. Install the new version of Post.Office.
  336.  
  337.    ./installpo
  338.  
  339.    The install script will "remember" where you had installed everything, 
  340.    and give you the option of skipping the Q&A. This procedure will not 
  341.    remove your current configuration files or change your existing accounts 
  342.    in any way.  When the installation program is finished, it will re-start 
  343.    Post.Office for you.
  344.  
  345.    CAUTION: The upgrade program will ask if you wish to change 
  346.    configuration information.  You should answer "no".  Only under 
  347.    exceptional circumstances while assisted by support personnel  
  348.    should you modify configuration information while upgrading.
  349.  
  350. 6. If you are currently using Program Delivery you will need to re-enable 
  351.    that feature by typing:
  352.  
  353.    chmod u+s /usr/local/post.office/local/Program-Deliver
  354.    rm /usr/local/post.office/trusted/NO-PROGRAM-DELIVERIES
  355.  
  356.    CAUTION: There are security issues associated with the use of Program 
  357.    Delivery.  Please read Appendix E of the Post.Office manual to ensure 
  358.    you understand those issues before enabling this feature.
  359.  
  360.  
  361. 7. If your UNIX mailboxes and POP mailboxes are stored in the same 
  362.    directory, you must cd to that directory and run the following file:
  363.  
  364.    <ProgramDirectory>/utils/FixMaildropFile *
  365.  
  366. ============================================================================
  367.  
  368.           INSTALLATION INSTRUCTIONS - POST.OFFICE v. 3.1 - UNIX
  369.  
  370. Details on the installation process can be found in the Post.Office 
  371. Installation Guide. Please review that manual to ensure that you have 
  372. met all pre-installation requirements.
  373.  
  374. Preparing for Installation:  Setting Up a User and Group for Post.Office
  375. ------------------------------------------------------------------------
  376.  
  377. One of the important security features of Post.Office is that the system 
  378. runs as a non-privileged user. Before installing the system, you must create 
  379. a new local user. All Post.Office programs run as this user ensuring that 
  380. they do not have privileged access to sensitive files. 
  381.  
  382. The primary group for this new user must also be newly created and have 
  383. no members (since any member of the group can read mail stored in the queue 
  384. or in a userÆs POP mailbox). Do not identify the mail group as the primary 
  385. group for your new Post.Office user since it is used by the UNIX mail system.
  386.  
  387. The method used to establish a new local group and new local user may vary 
  388. from platform to platform.  The instructions below are intended as a general 
  389. guide and may require slight modification for use with your system.
  390.  
  391. Create a new local group for Post.Office
  392.  
  393. 1. Log in as root.
  394.  
  395. 2. Edit the /etc/group file, adding a line like the one below to identify 
  396. the new local group (called mta) which is being created for Post.Office.
  397.  
  398. mta:*:<pogid>:
  399.  
  400. (where <pogid> is a number that uniquely identifies the new Post.Office group; 
  401. uniqueness guaranteeing that no users are given accidental access to mail 
  402. that is queued or stored in a POP mailbox)
  403.  
  404. Create a new local user for Post.Office
  405.  
  406. 1. As root, edit the /etc/passwd file, adding a line like the one below 
  407. to identify the new local user (also called mta) which is being created 
  408. for Post.Office.
  409.  
  410. mta:*:<pouid>:<pogid>:Post.Office User:/:/dev/null
  411.  
  412. (where <pouid> is a number that uniquely identifies the Post.Office user 
  413. and <pogid> is the number previously used to identify the Post.Office group)
  414.  
  415. Note:  On certain systems additional security is provided through use of 
  416. a shadow file.  If the /etc/shadow file is in operation on your system 
  417. you will also need to add the Post.Office user to that file following 
  418. the format dictated by your particular system.
  419.  
  420. Caution:  It is essential that the Post.Office group be named as the 
  421. primary group for the Post.Office user.  It is NOT sufficient to list 
  422. the Post.Office user as an auxiliary member of the Post.Office group.
  423.  
  424.  
  425. Running the Installation Program
  426. --------------------------------
  427.  
  428. Installation instructions vary slightly from platform to platform.  
  429. Please refer to the appropriate section below for specific installation 
  430. instructions for Solaris, HPUX10, and all other UNIX platforms.
  431.  
  432.  
  433. ---------------------------------------------------------------------------
  434.                      Solaris Installation Instructions
  435.  
  436. 1. Log on as root.
  437.  
  438. 2. Create a new user with no special privileges. Create a new group with this 
  439.    user as its only member. (Post.Office will run as this user.)  
  440.  
  441. 3a. If your software was delivered on CD:  mount the CD on your computer 
  442.     and change directory to the location containing the Post.Office files 
  443.     for your particular operating system/platform.
  444.  
  445. 3b. If you downloaded the software from our ftp or web site:  uncompress the 
  446.     file you downloaded into a temporary directory and expand the resulting 
  447.     archive file to create the Post.Office package (SCOM-MTA) by typing:
  448.  
  449.     cd /var/tmp
  450.     uncompress PO31-solaris2.tar.Z
  451.     tar xvpf PO31-solaris2.tar
  452.  
  453. 4. Install the new package by typing:  
  454.    pkgadd -d . SCOM-MTA
  455.  
  456.    Remember:  When assigning locations for the Post.Office directories, 
  457.    do not store the POP mailboxes in the same directory as your UNIX 
  458.    mailboxes, and do not store the Program Directory within the Post.Office 
  459.    Spooling Directory.
  460.  
  461. 5. Run the Post.Office configuration program:  /opt/post.office/Setup
  462.  
  463.    This process allows you to configure the new software, setting 
  464.    parameters as desired. (Note: you must cd to the /opt/post.office 
  465.    directory before running Setup.)
  466.  
  467.    When the Setup program is finished, it will start Post.Office for you.
  468.  
  469. ---------------------------------------------------------------------------
  470.                       HPUX10 Installation Instructions
  471.  
  472. 1. Log on as root.
  473.  
  474. 2. Create a new user with no special privileges. Create a new group with 
  475.    this user as its only member. (Post.Office will run as this user.)  
  476.  
  477. 3a. If your software was delivered on CD:  mount the CD on your computer, 
  478.     change directory to the location containing the archive file for the 
  479.     appropriate UNIX platform, copy that archive into a temporary directory, 
  480.     and expand it by typing:
  481.  
  482.     cp XXX.tar* /usr/tmp
  483.     cd /usr/tmp
  484.     tar xvpf XXX.tar*
  485.  
  486.     (where XXX represents your platform type)
  487.  
  488. 3b. If you downloaded the software from our ftp or web site:  uncompress the 
  489.     file you downloaded into the temporary directory and expand the resulting 
  490.     archive file by typing:
  491.  
  492.     cd /usr/tmp
  493.     uncompress PO31-XXX.tar.Z
  494.     tar xvpf PO31-XXX.tar
  495.  
  496.     (where XXX represents your platform type)
  497.  
  498. 4. Change to the newly created directory and install Post.Office version 3.1.
  499.  
  500.    cd Post.Office
  501.    ./installpo
  502.  
  503.    Remember:  When assigning locations for the Post.Office directories, 
  504.    do not store the POP mailboxes in the same directory as your UNIX 
  505.    mailboxes, and do not store the Program Directory within the Post.Office 
  506.    Spooling Directory.  Also, for HP systems only, no two Post.Office 
  507.    directories may reside in the same parent directory.
  508.  
  509.  
  510. ---------------------------------------------------------------------------
  511.             Installation Instructions for all Other UNIX Platforms
  512.  
  513. 1. Log on as root.
  514.  
  515. 2. Create a new user with no special privileges. Create a new group with 
  516.    this user as its only member. (Post.Office will run as this user.)  
  517.   
  518. 3a. If your software was delivered on CD:   mount the CD on your computer 
  519.     and change directory to the location containing files for your particular 
  520.     operating system/platform.
  521.  
  522.        Digital UNIX Note:  The default options used to mount a CD may not 
  523.        be appropriate.  Be sure to specify "cdfs" as the file system type 
  524.        and include the Rock Ridge Interchange Protocol option "rrip".
  525.  
  526.           For example, if your CD ROM device is assigned a SCSI-ID of 6 
  527.           and you want to access the CD ROM from the directory /CDROM, 
  528.           you would use the following command:  
  529.  
  530.           mount -r -t cdfs -o ro,rrip /dev/rz6c /CDROM
  531.  
  532.        SunOS Note:  The default options used to mount a CD may not 
  533.        be appropriate.  Be sure to specify "hsfs" as the file system type.
  534.  
  535. 3b. If you downloaded the software from our ftp or web site:   uncompress the 
  536.     file you downloaded into a temporary directory, expand the resulting 
  537.     archive file, and then change to the newly created directory by typing:
  538.  
  539.     cd /var/tmp
  540.     uncompress PO31-<platform>.tar.Z
  541.     tar xvpf PO31-<platform>.tar
  542.     cd Post.Office
  543.  
  544. 4. Install the new version of Post.Office.
  545.  
  546.    ./installpo
  547.  
  548.    Remember:  When assigning locations for the Post.Office directories, 
  549.    do not store the POP mailboxes in the same directory as your UNIX 
  550.    mailboxes, and do not store the Program Directory within the Post.Office 
  551.    Spooling Directory.